home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-20
/
qqsl54.zip
/
QQSL_CD.EXE
/
QQSLCD.DOC
< prev
next >
Wrap
Text File
|
1993-02-25
|
24KB
|
553 lines
QQSLCD
Ver. 5.0
Author
Tom Palko, WB5ASD
P.O. Box 8762
Alexandria, LA 71306-1762
(318) 445-2364 - Voice
(318) 448-6273 - FAX
CompuServe Id. 72216,3067
American Silver Dollar BBS
(318) 443-0271 - 9600 BBS
QQSLCD
Companion program to QQSL(tm) by Bill Mullin, AA4M/6
This program prints mailing address labels of U.S. and
foreign amateurs, using data from the QQSL program
(specifically the QQSL.LBL file), and then searching the
HamCall CDROM disc for the address information.
Now with HP LASERJET+ support!
Now supports ICALL - International calls!
A CD ROM drive is required along with the Buckmaster
HamCall CD disc to fully operate this program.
TABLE OF CONTENTS
AUTHOR: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
CIS Id.: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
American Silver Dollar BBS:. . . . . . . . . . . . . . . . . . . . . 1
FAX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Voice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Latest version of QQSLCD . . . . . . . . . . . . . . . . . . . . . . 1
PRINT THIS DOCUMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
dot matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
laser printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
INTRODUCTION: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Buckmaster CD ROM. . . . . . . . . . . . . . . . . . . . . . . . . . 1
print mailing labels for U.S., VE, and other foreign amateurs. . . . 1
QQSL.LBL file. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
QQSLCD.LBL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
later printing . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
With version 4.0 is HP LaserJet+ support.. . . . . . . . . . . . . . 2
count feature. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
SAVING DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
VIRUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ABOUT THE EVALUATION VERSION. . . . . . . . . . . . . . . . . . . . . . . 3
RETURN ADDRESS LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . 4
reentering the information . . . . . . . . . . . . . . . . . . . . . 4
PRINTING AND LABEL ALIGNMENT. . . . . . . . . . . . . . . . . . . . . . . 4
IBM/Epson compatible . . . . . . . . . . . . . . . . . . . . . . . . 4
Printer error. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
time out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
HP LASERJET+. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Avery 5161 form. . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Avery 5160/5660 form . . . . . . . . . . . . . . . . . . . . . . . . 4
Avery 5351 form. . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Copier Labels. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
10 cpi Courier . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
12 cpi Elite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Printer error. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
time out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CALL SIGNS: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
slashed zero . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
WHAT IS PROCESSED:. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
ESCAPE ROUTES:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
QQSLCD: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
QQSL.LBL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
QUICK START:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
FASTOPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
PARAMETERS: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CDROM drive letter as the first parameter and the printer port as
the second parameter. . . . . . . . . . . . . . . . . . . . . . 6
ADDITIONAL PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Sound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
printer control codes. . . . . . . . . . . . . . . . . . . . . . . . 7
N = No sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
LIMITATIONS:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
ABOUT SHAREWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
REGISTRATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
license. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
DISCLAIMER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Comments/Suggestions . . . . . . . . . . . . . . . . . . . . . . . . 9
AUTHOR:
=======
QQSLCD was designed and programmed by:
Tom Palko, WB5ASD
P.O. Box 8762
Alexandria, LA 71306-1762
CIS Id.: 72216,3067
American Silver Dollar BBS:
(318) 443-0271 9600 Hayes Ultra V.32, V.42bis, MNP5
FAX (318) 448-6273 (automatic switching to FAX
Voice (318) 445-2364 Human or Answering machine. I probably won't return
any long distance calls.
Latest version of QQSLCD can always be found on the "American Silver Dollar
BBS".
TO PRINT THIS DOCUMENT:
=======================
This document has been formatted for printing on a dot matrix or laser
printer. Top margins, bottom margins, headers, and footers with page numbers
have all been built into the file. From the DOS prompt, simply enter:
TYPE QQSLCD.DOC > PRN
or
TYPE QQSLCD.DOC > LPT2
INTRODUCTION:
=============
QQSLCD does several things:
1. QQSLCD looks up names and addresses using the Buckmaster CD ROM.
2. It will print mailing labels for U.S., VE, and other foreign amateurs
using the QQSL.LBL file from QQSL(tm). This means that several
different contest logs may be read into QQSL and then processed by
QQSLCD. Great for 10/10, county hunters, WAS, 5BWAS, Grid Squares, and
now DX and world wide contests!
3. It leaves the results in a useable file (QQSLCD.LBL) that may be edited
and/or printed later. (TYPE QQSLCD.LBL > PRN) will do it! Of course the
labels may be printed directly from QQSLCD.
4. You may add more to the file for later printing. Nice if you don't have
labels loaded and or only QSL every week or two.
5. With version 4.0 is HP LaserJet+ support. QQSLCD supports 3 styles of
laser/copier labels. The 2 up Avery 5161 Laser Printer labels, Avery
5160 3 up Laser Printer labels, and Avery 5351 (garden variety) 3 up
copier labels.
6. With version 4.0 is a second count feature. The program now counts the
number of calls to search and displays the number of labels that are
already on the disc ready to print.
7. With version 4.0 is the printing of return address labels! With the
IBM/Epson DMP printers you may print from 1 to 32,000 return address
labels after printing the mailing labels. With the HP LAserJet+ you
have the option of filling the remaining blank labels on the last page
with return address labels.
8. *** NEW *** with version 5.0 is the long awaited foreign call support!
QQSLCD will process U.S. and VE calls with the unregistered version.
Registered owners will receive the full benefits of the new ICALL and
process ALL calls!!!
Version (3.xx series) added windows with color screens, more error checking,
better sound and better user friendly program flow. Also you can test QQSLCD
without the CDROM! Nothing great here as it needs the CDROM to get the real
data but if you have not yet purchased your CDROM drive and HamCall disc you
can at least look at how it operates. You can even print out the sample
QQSLCD.LBL file and see the output on your printer.
The program was written and tested with a IBM (compatible) 386/33 computer,
Maxtor 200 Meg IDE hard drives, Sony external CDROM reader, color VGA
adapter and monitor. The source code and compiling was accomplished with
Borland's Turbo Pascal 6.0 Professional under DOS 4.01. Portions of this
program are copyrighted by Borland International, Inc..
There are no system specific calls or fancy code that writes to system
memory, or makes any changes to the interrupts. Multitasking with DesQview
or other systems should not be a problem.
I have tested it on the following IBM/compatible; 10 Mhz Laser Turbo XT
w/Hercules/CGA Graphic Adapter, Epson Equity III+ 10 Mhz AT w/VGA adapter
and Mono VGA monitor, PC Turbo 386/33 w/VGA color. No problems were
encountered on any of these systems.
CGA SNOW:
=========
CGA snow removal is automatic and accomplished by Turbo Pascal 6.0 without
any intervention on my part or yours.
SAVING DATA:
============
The labels are automatically saved to a file rather than being written
directly to continuous-form labels. This means that the normal hassle of
loading label paper into the printer each time QQSLCD is invoked can be
avoided until you are ready to print labels.
VIRUS:
======
VIRUS checking; My system is scanned regularly for any virus infection and
most especially before zipping the archive. So, if you downloaded it from
CompuServe or the American Silver Dollar BBS it should be clean. If you got
it from any other system you're on your own.
WHY QQSLCD:
===========
Although I really had no need for this program, the desire to write it came
after looking at Bill Mullin's, AA4M/6, QQSL(tm) program. It printed the
label for the front of a QSL card (looking good too!) and the labels were
already loaded into the printer... why not! After writing a REQQTH server
for the W0RLI packet bbs to look up addresses from the call signs I could
see that it could also be written to read the QQSL.LBL file, look up and
print labels.
So, if you have invested in a CDROM reader and have the Buckmaster HamCall
disc you're in business!
AUTOMATED MAILING LABELS!
WISH LIST:
==========
This is your area! Please send me a little feedback and I'll see what can be
done about it.
ABOUT THE EVALUATION VERSION:
=============================
If you haven't registered your copy of QQSLCD, then you'll find that the
version of QQSLCD you're using is identical to that used by paid users,
registration will eliminate the nag/beg screen and delays can be eliminated.
Also with Version 5.0 U.S. calls and now VE calls are processed.
Registration will allow you to process ALL calls!!! Just add the
registration code and all functions are available.
"There is no such thing as a free lunch!" Shareware depends on your
financial support to exist. Programs that allow you to use your computer to
save your valuable time and reduce your effort deserve recognition and
support.
PROGRAM OPERATION:
==================
QQSLCD is a companion program to QQSL(tm) by Bill Mullin, AA4M/6, and is
designed to look up Names and addresses of HAMs world wide from Buckmaster's
HamCall CD ROM and print mailing labels. QQSLCD reads the QQSL.LBL file to
extract the call sign information. Only calls starting with A, K, N, and W
are processed.
Upon registration I will send you the code to turn off the delays and "beg"
screens and allow processing of Ham Calls world wide!
RETURN ADDRESS LABELS
=====================
The first time the program runs it will ask for your return address
information. A maximum of 5 lines may be entered. The information is stored
in a file called RETURN.ADD. I do not recommend editing this file even
though it is straight ASCII as many forget when using a word processor to
use the non-document mode or may change the number of lines. There is a main
menu selection that will allow reentering the information thus avoiding any
unnecessary headaches.
PRINTING AND LABEL ALIGNMENT: Dot Matrix printers.
=============================
After printing labels with QQSL(tm) just leave your printer loaded, do not
advance the forms and you should get a good looking printout. The program
sends only 1 (one) control signal to the printer. Character = 14 or 0Eh that
puts the printer (IBM/Epson compatible) into expanded print for the first
line to create a label similar to what QQSL(tm) prints for the first line.
Printer error; The program waits for DOS to time out before reporting a
printing fault. This may take 30 to 60 seconds or more before timing out.
Trying to print without a printer hooked up or in some cases a printer that
is not turned on will cause a printer fault error that will cause the
program to halt. QQSLCD will report a faulty printer on program exit. Make
sure your printer is connected to the computer and turned on then rerun the
program.
HP LASERJET+
============
The main menu option "H" will bring up the HP LaserJet+ options.
1. Avery 5161 form is a 2 up "Laser Printer" form with 20 - 1" x 4"
labels. This is the same label as used by QQSL(tm) for printing the
report labels.
2. Avery 5160/5660 form is a 3 up "Laser Printer" form with 30 - 1" x 2
5/8" labels. All 30 are printable.
3. Avery 5351 form is a 3 up "Copier Labels" form with 33 - 1" x 2 5/8"
labels. This program will only make 27 labels per page due to the way
the HP LaserJet+ is able to print and produce a nice label. This form
was included because they are commonly available while the "Laser
Printer" labels may be a bit harder to find.
The HP LaserJet+ produces a 'slashed zero' for call signs only and does not
use the expanded print.
Fonts: QQSLCD expects to find the HP LaserJet+ in the default startup mode
with 10 cpi Courier selected. The program will select 10 cpi Courier for the
2 up labels and 12 cpi Elite for the 3 up label forms.
Printer error; The program waits for DOS to time out before reporting a
printing fault. This may take 30 to 60 seconds or more before timing out.
Trying to print without a printer hooked up or in some cases a printer that
is not turned on will cause a printer fault error that will cause the
program to halt. QQSLCD will report a faulty printer on program exit. Make
sure your printer is connected to the computer and turned on then rerun the
program.
CALL SIGNS:
===========
Call signs entered like Bill's, AA4M/6, N5ABC/I6 or I6/N3ABC are truncated
at the "/" for look up on the CD ROM i.e., AA4M or N5ABC but on the label
they are printed as entered in QQSL(tm) i.e., AA4M/6 or N5ABC/I6.
The laser output will print a 'slashed zero' for the call sign only. The
address numbers and zip codes print the normal zero.
WHAT IS PROCESSED:
==================
QQSLCD will only process calls that begin A, K, N, W and VE with the
unregistered version. Previous versions only processed U.S. amateur calls.
With version 5.0 VE calls will also work. Registration will allow you to
process ALL call signs!
ESCAPE ROUTES:
==============
QQSLCD looks for a Esc key being pressed during CD ROM access and during
printing. This is not interrupt driven but looks to see if a key was
pressed during the last sequence (each call processed or label printed).
QQSLCD:
=======
QQSLCD reads the QQSL.LBL file. It does NOT WRITE to this file! The file,
QQSL.LBL, is opened and the data is read in and displayed on the screen. As
always, if the data is important and you worry, make a BACKUP first!
Please report any bugs or wish list items to the author.
QUICK START:
============
**** ICall.exe must be in the PATH. ****
Copy ICall.exe from the CD ROM to a subdirectory in your PATH. This is done
for speed as ICall.exe loads for every call that is looked up and to do that
from the CDROM takes quite a bit of time. I have mine located with the DOS
files, i.e., C:\DOS which allows program access from any directory and only
1 copy is required on the hard disk. It may also be in the current directory
and will operate a bit faster finding it there rather than looking through
the PATH until finding the program.
FASTOPEN.SYS is another help that will speed things up and should be in your
CONFIG.SYS file as the program opens and closes files many times. FASTOPEN
keeps track of the last few files that were accessed and their location.
Knowing the location DOS may then go directly to the file rather than having
to look in the directory and FAT tables.
QQSLCD E: LPT1
^ ^ ^
| | |
| | Printer (LPT1, LPT2 or LPT3)
| CDROM Drive
Program name
Also see GO.BAT for an example of running QQSL and follow with QQSLCD using
drive G: as the CDROM.
DEMO without CDROM: To run QQSLCD without a CDROM drive just start the
program as above and pass the drive parameter as the
current drive. This will stop the program from halting
(finding ICall.exe) and allow you to make a pass looking
up addresses. It will then run but never find any
addresses (ya gotta have the CDROM!).
PARAMETERS:
===========
You must pass at least the CDROM drive letter as the first parameter and the
printer port as the second parameter. Example below is for a CDROM = drive
G: and using LPT2.
QQSLCD G: LPT2
ADDITIONAL PARAMETERS:
======================
Additional parameters may be passed to the program but the first and second
parameter must be the CD ROM drive and printer port.
*** Sound and Non-IBM/Epson compatible printers: ***
When starting QQSLCD the use of the following parameters will prevent
printer control codes and/or turn off the sound.
parameter = 1 = no printer control codes
parameter = N = No sound ( MUST BE CAPITALIZED!!)
It makes no difference in the order or if 1 or both are used.
QQSLCD G: LPT1 1 { no printer control codes - sound on }
QQSLCD G: LPT1 N { no sound - control codes are sent to printer }
QQSLCD G: LPT2 1 N { no sound, no printer control codes }
QQSLCD G: LPT1 N 1 { no sound, no printer control codes }
LIMITATIONS:
============
In order to make the program a bit faster and the QQSL.LBL file safer from
accidental corruption QQSLCD reads the call signs into memory with a limit
of 2048. This could be increased at the expense of more memory so for the
multitasking users I held it to a reasonable limit. One could process 2048
and not print the labels then go back to QQSL and do another 2048 batch and
append to the new labels to the ones on the disk and then print the address
labels but I doubt many will exceed this limitation. If you are exceeding
this limit it is my fault not yours! Please drop me a note and let me know
what is going on so I know if I need to increase this limitation. This is
not intended to limit the operation.
NOTE: This limit is only on the number of calls to search and NOT the number
of labels. The number of labels is only limited by the amount of disc space
you have available.
ABOUT SHAREWARE:
================
Shareware distribution gives users a chance to try software before buying
it. If you try a Shareware program and continue to use it, you're expected
to register!
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights. Shareware authors are accomplished
programmers, just like commercial authors, and the programs are of
comparable quality. In both cases, there are good programs, bad programs,
and indifferent programs! The main difference is in the method of
distribution. The author specifically grants the right to copy and
distribute the software, either to all and sundry or to a specific group.
For example, some authors require written permission before a commercial
diskette vendor may copy their Shareware.
So, Shareware is a distribution method, not a type of software. You should
find software that suits your needs and pocketbook, whether it's commercial
or Shareware. The Shareware system makes fitting your needs easier, because
you can try before you buy. And because the overhead is low, prices are low
also. Shareware has the ultimate money-back guarantee - if you don't use the
product, you don't pay for it!
REGISTRATION:
=============
You are granted a license to try this program for a period of 90 days. If
you continue to use it after the trial period, you must register by sending
the registration form and a donation to the author as shown on the
registration form. For $20 or more I'll mail you the key to eliminate the
"beg" screens and enable processing of ALL calls!
At least send in the registration form with your comments, even if you don't
send a donation. This will give me an idea of how large of a user base there
is. I would like to hear from you and read your comments.
I won't make a profit on this program, even if ALL who register were to pay
more than the suggested amount! The time and effort required to produce this
code and personal expenses for both hardware and software is tremendous! It
just helps a little in keeping current software to write more programs.
DISCLAIMER:
===========
The author assumes no responsibility for the results produced by QQSLCD,
either to your software, hardware, or storage media. While I've made every
effort to ensure that this software works properly, I know better than to
claim that you'll never experience problems while using it.REGISTRATION FORM
=================
To register QQSLCD, please send this form and your donation of $20.00 (U.S.
funds or IRC's) to:
Tom Palko - WB5ASD
P.O. Box 8762
Alexandria, LA 71306-1762
U.S.A.
NAME: ____________________________________ Call: ____________
ADDRESS: ________________________________________________________
________________________________________________________
Where did you get your copy of QQSLCD?
( ) Compuserve CIS User ID: _______________________________
( ) BBS (Name/QTH): _____________________________________________
( ) Other (please specify): _____________________________________
Which version of QQSLCD are you using? __________________________
Computer? _______________________________________________________
HD Size/Type? _____________ Monitor (CGA, EGA, VGA, ...)? _______
Comments/Suggestions: ___________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
TNX for registering QQSLCD!